═══ 1. JumpKey/2 General Help ═══ Use these HELP panels to find out how to use JumpKey/2. General Help is available for the following items:  Overview  Command Line  Menu Help ═══ 2. Overview ═══ JumpKey/2 allows you to set up key combinations that will jump directly to a specific OS/2 Window. You can configure up to 32 JumpKey/2 sessions to jump to as well as up to 32 sessions that will be toggled in a ring. You can configure the keys that will initiate each jump, as well as the titles that are jumped-to. Almost every key can be defined to make a jump. There is only one default key assignment: shift-ctrl-0 = Make JumpKey Visible If this is the first time you have started JumpKey/2, Configure will be automatically selected from the Options menu to set up session titles and keys. Double click HERE for more details on the Configuration panel. JumpKey/2 can be hidden while it operates or you can leave it as an icon, or a displayed window. Any items that you configure can be saved for the next time you start JumpKey/2. Note: You CANNOT jump FROM a FULL-SCREEN session, such as a Full-Screen Command Prompt, or Full-Screen DOS. You ARE permitted to jump TO one of these sessions. ═══ 3. Command Line ═══ You can start JumpKey/2 with the command: start JumpKey [options] or you can place the command line options as parameters in the settings notebook for the program object. The options that can be specified are: Option Action /h Makes JumpKey/2 hide. It will still operate, but you will not be able to see it, and there will not be an entry in the Window List. If you want to see the window again, you can either:  Start JumpKey/2 again. This will not start another copy of the program. It will make the first copy visible again.  Use the shift-ctrl-0 key to make the JumpKey/2 program visible. Use the Configure menu item to set up another key combination to perform this action.  Double-click on the object in the folder where you started JumpKey/2. /n Starts JumpKey/2 as an icon. /d Uses all program defaults. This will cause JumpKey/2 to discard any options you have previously saved. The '/' is optional. For example, to specify ALL the options, use the command: start JumpKey /hnd The options can be in ANY order. Note: Make sure that the following DLLs hotdll32.dll jumpres.dll are located somewhere in the LIBPATH. If it is NOT, you will receive the message: The system cannot find the file HOTDLL32. from OS/2. ═══ 4. Menu Help ═══ The main menu can be selected by clicking on the menu items, or pressing the Alt key and an underlined letter on the menu.  Actions  Options  Help ═══ 4.1. Actions ═══ The Actions menu contains the following item:  Hide ═══ 4.1.1. Hide ═══ This menu item will make the JumpKey/2 program invisible. It will continue to operate, but you will not see the program on the Desktop, as an Icon, or in the Window List. To make the program visible again you can:  Start JumpKey/2 again. This will not start another copy of the program. It will make the first copy visible again.  Use the shift-ctrl-0 key to make the JumpKey/2 program visible. Use the Configure menu item to set up another key combination to perform this action.  Double-click on the object in the folder where you started JumpKey/2. You can invoke this function with the keyboard by pressing Alt+F11. ═══ 4.2. Options ═══ This options menu has three menu items:  Configure  View keys ═══ 4.2.1. Configure ═══ This menu item will initiate the JumpKey/2 configuration Panel. On this panel you can set up:  The keys to be used for JumpKey/2.  The names of the sessions that will be jumped to. Double click HERE for more details on the Configuration panel. ═══ 4.2.2. View keys ═══ This menu item will let you see the keys that you currently have configured. The list includes:  The names of the keys that are associated with a jump session.  The names of the sessions that will be jumped to. Double click HERE for more details on the defined keys panel. ═══ 4.3. Help Menu Help ═══ The Help menu lets you find out more information about the program. ═══ 4.3.1. Help for Help Index ═══ This menu item displays the Help Index. ═══ 4.3.2. Help for General Help ═══ This menu item will start the help system at the first JumpKey/2 help panel. ═══ 4.3.3. Help for Keys ═══ This menu item tells you keys that JumpKey/2 uses on its main panel. ═══ 4.3.4. Help for Help ═══ This menu item tells you how to use the OS/2 help system. ═══ 4.3.5. Product Information ═══ The Product Information Panel contains the Copyright and program version. ═══ JumpKey/2 Configuration ═══ This dialog panel lets you set up the keys to be used for JumpKey/2 as well as the titles used for the session names. More detail is available for:  Defining a Key  Shift Key Settings  Key Names  Definitions  Session Title Edit  Maximize Session  Exact Match  Toggle Session List  Toggle Session Edit  Skip Minimized  Toggle through like-named sessions  Do not jump to hidden windows  OK  Cancel ═══ Defining a Key ═══ To define a key, follow these steps: 1. Select the key you want to define from the Key Names list, or select a shift key setting and then select a key from the displayed keyboard by pressing a key with the mouse. The current definition for this key will be displayed in the Definition list. 2. Select a new definition in the Definition list. 3. Move the cursor to the Session Title Edit box and type in a session title or select one from the session title pulldown list. The pulldown list has everything currently in the Window List. 4. Click on the Maximize Session check box if you would like this session to maximize when you jump to it. 5. Click on the Exact Match check box if you have sessions with similar names, and you want to jump only if there is an exact title match. 6. The list of sessions for the Toggle function will display all the active 3270 sessions. You can change this list by modifying the order of the items, or adding or deleting items from the list. Double click HERE for more details on Toggle sessions. When you have finished defining ALL your keys, press the OK button. If you want to discard your changes to the defined keys, press the Cancel button. ═══ Keys Help ═══ Alt-F11 performs the JumpKey/2 hide function from the JumpKey/2 main window. See your OS/2 reference for more information on standard key usage. For help setting up keys for JumpKey/2, click HERE. ═══ Shift Key Settings ═══ If you are using the displayed keyboard to select a key, you can set the shift state by selecting from one of the five buttons below the keyboard:  No Shift Keys  Shift Pressed  Ctrl Pressed  Alt Pressed  Shift+Ctrl Pressed Double click HERE for more details on defining a key. ═══ No Shift Keys ═══ When this radio button is selected, the key generated by pressing a key button will not be combined with a shift key. ═══ Shift Pressed ═══ When this radio button is selected, the key generated by pressing a key button will be combined with either the left or right shift key. ═══ Alt Pressed ═══ When this radio button is selected, the key generated by pressing a key button will be combined with either the left or right Alt key. ═══ Ctrl Pressed ═══ When this radio button is selected, the key generated by pressing a key button will be combined with either the left or right Ctrl key. ═══ Shift+Ctrl Pressed ═══ When this radio button is selected, the key generated by pressing a key button must be combined with either the left or right Shift key and either the left or right Ctrl key. ═══ Key Names ═══ This list is an alphabetical list of the keys available for redefinition. You can either select an entry on this list, or press a button in the displayed keyboard above this list. If the key is not present on an old PC keyboard, the name will have -enh appended to the end of the key name. For example, the home key on the center of a Model 70 keyboard is known as home-enh, while the home key on the numeric keypad is simply home. The keys may also have a prefix of: alt- indicates holding either ALT key and pressing the key. ctrl- indicates holding either CTRL key and pressing the key. shift- indicates holding either SHIFT key and pressing the key. shift-ctrl- indicates holding either SHIFT key AND holding either CTRL key while pressing the key. Double click HERE for more details on defining a key. ═══ Definition List ═══ The following definitions are available: Name Action No Action JumpKey/2 takes no action for the key. It is passed on to the Active OS/2 application. Make JumpKey/2 Visible will make JumpKey/2 visible again if it is hidden. If JumpKey/2 is already visible, this key will bring JumpKey/2 to the foreground. Toggle Forward this will have one of two actions, depending on the Active OS/2 application. 1. If the Active OS/2 application is NOT one of the configured Toggle Sessions, JumpKey/2 will jump to the FIRST Toggle Session. 2. If the Active OS/2 application IS one of the Toggle Sessions, JumpKey/2 will jump to the NEXT Toggle Session. When this item is selected, you cannot select the Session Title Edit box. Toggle Backward this will have one of two actions, depending on the Active OS/2 application. 1. If the Active OS/2 application is NOT one of the configured Toggle Sessions, JumpKey/2 will jump to the FIRST Toggle Session. 2. If the Active OS/2 application IS one of the Toggle Sessions, JumpKey/2 will jump to the PREVIOUS Toggle Session. When this item is selected, you cannot select the Session Title Edit box. Toggle Minimize this will minimize all Toggle sessions that are configured in the Toggle Session Title List. When this item is selected, you cannot select the Maximize Session, or the Session Title Edit box. Windows that support the hide function, instead of minimize, will be hidden instead. Toggle Maximize this will maximize all Toggle sessions that are configured in the Toggle Session Title List. When this item is selected, you cannot select the Maximize Session, or the Session Title Edit box. Toggle Restore this will restore all Toggle sessions that are configured in the Toggle Session Title List. When this item is selected, you cannot select the Maximize Session, or the Session Title Edit box. Minimize All this will minimize all running programs. Windows that support the hide function, instead of minimize, will be hidden instead. Maximize All this will maximize all running programs. Restore All this will restore all running programs. Lockup System this will invoke the built-in lockup function of the OS/2 desktop. Shutdown System this will invoke OS/2 shutdown procedure. Each of these will jump to the specified OS/2 session. When configured, the name of this session will be displayed in definition list and in the the Session Title Edit box above this list, where it can be changed. The term 'not defined xx' (where xx is a number from 1 to 32) will be displayed for each entry in the list until a session name has been entered for the item. Double click HERE for more details on defining a key. ═══ Session Title Edit ═══ This is a combination box where you can either type the name of the session to be jumped-to for the session number displayed in the Definition List, or you can pull down the list of sessions as displayed in the Window List. If you click on the arrow to the right of this box, a list of all the currently running sessions will be displayed. Select the session with the keyboard or mouse. The item can be any part of a title in the Window List. Remember that the first match for this title will be the session that is jumped-to. The search is NOT case-sensitive, but any blanks or punctuation must be included just as displayed in the Window List. Note: You cannot select or type into this field unless a jump session title is selected in the Definition List. Double click HERE for more details on defining a key. ═══ Maximize Session ═══ This check box should be selected if you would like the session whose name is displayed in the Session Title Edit box to become maximized when JumpKey/2 switches to it. Some applications will fill the entire screen when maximized. Others will change shape, but still not fill the entire screen. This option will cause the application to enlarge itself to its largest size. Note: You cannot select this check box unless Toggle Forward, Toggle Backward or a jump session title is selected in the Definition List. Double click HERE for more details on defining a key. ═══ Exact Match ═══ This check box should be selected if you would like to jump to the session whose name is displayed in the Session Title Edit box only if it is an EXACT match for a Window List entry. You may have applications with similar names, or names that are extensions of a name, for example: Command Window Command Window:2 If you defined a Session Title called Command Window, and you want to make sure JumpKey/2 always jumps to the first of the two task list entries above, you would need to select Exact Match. Note: You cannot select this check box unless a Toggle function or a jump session title is selected in the Definition List. Double click HERE for more details on defining a key. ═══ Toggle Session Title List ═══ This is a list box that contains the names of your 3270 sessions. These applications will be accessed by the keys defined as Toggle Minimize, Toggle Forward or Toggle Backward in the Definition List. The Toggle Forward and Toggle Backward keys will have one of three actions, depending on the Active OS/2 application. 1. If the Active OS/2 application is NOT one of the toggle sessions, JumpKey/2 will jump to the FIRST toggle session. 2. If the Active OS/2 application IS one of the toggle sessions, Toggle Forward will jump to the NEXT toggle session; Toggle Backward will jump to the PREVIOUS toggle session. 3. If Skip Minimized has been selected, JumpKey/2 will not switch to Minimized sessions. Instead, the next or previous restored or maximized session will be switched-to. If you have not started, or you do not have the Communications Manager, this list will be empty. To make this list correct, start the Communications Manager before configuring JumpKey/2. To change an item in the list, use the cursor or the mouse to select an item, then edit the item as displayed in the Toggle Session Title Edit box, located just above the list, or select one from the Toggle Session Title Edit pulldown list. The terms 'not defined xx' will be displayed in the Toggle Session Title List (where xx is a number from 1 to 32) until an entry has been made for this item. Note: You cannot select this list unless toggle Minimize, Toggle Forward or Toggle Backward is selected in the Definition List. Double click HERE for more details on defining a key. ═══ Toggle Session Title Edit ═══ This is a combination box where you can either type the name of the session to be jumped-to for the toggle function, or you can pull down the current list of Communications Manager sessions. If you click on the arrow to the right of this box, a list of all the currently running Communications Manager sessions will be displayed. Select the session with the keyboard or mouse. Simply type over any values displayed in this box, or select from the pull down list. Then Click on OK to accept the change. To delete an item from the Toggle list, simple blank-out or delete all the characters in the item, then select another item in the list. The list will be adjusted for the now empty entry. The entry will be changed to read: Note: You cannot select or type into this field unless toggle Minimize, Toggle Forward or Toggle Backward is selected in the Definition List. Double click HERE for more details on defining a key. ═══ Skip Minimized ═══ This check box should be selected if you would like JumpKey/2 to bypass Toggle Sessions that are minimized. When this option is selected, the keys defined as the toggle Forward and Toggle Backward will jump to the next or previous restored or maximized session defined in the Toggle Session Title List. If NONE of the defined sessions are restored or maximized, JumpKey/2 will jump to the first session. Note: You cannot select this check box unless toggle Minimize, Toggle Forward or Toggle Backward is selected in the Definition List. Double click HERE for more details on defining a key. ═══ Toggle Through Like-Named Sessions ═══ This check box affects all sessions except the toggle sessions. If selected JumpKey/2 will loop through all sessions that match the session title. For example, let us assume that you used the LaunchPad to start several sessions that have a title of "OS/2 Window". Let us also assume that you have another session called "Command Window". Use the JumpKey/2 settings to configure the key ctrl-1 to jump to a session titled "WINDOW" and do not select exact match. If Toggle Through Like-Named Sessions is ON, each time you pressed ctrl-1, JumpKey/2 would in turn toggle to each of the sessions titled "OS/2 Window", and then also toggle to the session titled "Command Window". If Toggle Through Like-Named Sessions is OFF, each time you pressed ctrl-1, JumpKey/2 would jump only to the first session it found. This could be one of the "OS/2 Window" sessions or the session titled "Command Window". Use the JumpKey/2 settings to configure the key ctrl-1 to jump to a session titled "OS/2 WINDOW" and DO select exact match. If Toggle Through Like-Named Sessions is ON, each time you pressed ctrl-1, JumpKey/2 would in turn toggle to each of the sessions titled "OS/2 Window", but would not toggle to the session titled "Command Window". If Toggle Through Like-Named Sessions is OFF, each time you pressed ctrl-1, JumpKey/2 would jump only to the first session titled "OS/2 Window" that it found. Double click HERE for more details on defining a key. ═══ Do Not Jump To Hidden Windows ═══ This check box affects all sessions except the toggle sessions. If selected JumpKey/2 will not jump to windows which are hidden from view in the Window List. If you have trouble jumping to a session, try turning this option OFF. Double click HERE for more details on defining a key. ═══ Defined Keys Panel ═══ This dialog panel lets you view the keys that are currently defined. The list that is provided contains two columns:  The names of the defined keys.  The definition for the keys. If you double-click on a list item, JumpKey/2 will try to switch to that session. If you have chosen a toggle or system function, a warning tone will sound. At the bottom of this panel are buttons to select:  Close - removes this dialog panel.  Print - sends the displayed list to the printer defined as LPT1. You will hear a confirmation tone when the list has been sent to the printer. ═══ OK ═══ Pressing the OK button accepts any changes on this panel and removes the panel. Settings are saved in JUMPKEY.INI in the \OS2 directory on your boot drive. ═══ CANCEL ═══ Pressing the CANCEL button discards any changes on this panel and removes the panel. If changes have been made, you will be asked to confirm before discarding the changes. ═══ Print ═══ Pressing the PRINT button sends the displayed list to the printer defined as LPT1. You will hear a confirmation tone when the output has been sent to the printer. ═══ No Help for this Panel ═══ There is no Help for this Panel. Double click HERE for extended help. ═══ ═══ Press Ctrl-Esc, or click the right mouse button on the Desktop Background. The displayed list contains all active OS/2 applications. ═══ ═══ This is the OS/2 application that has a highlighted border and is receiving all keyboard input. ═══ ═══ An entry in the JumpKey/2 Toggle Session Title list.